Skip to content

feat(twelvedata): add Twelve Data market data plugin - #155

Open
pavel-osetrov wants to merge 1 commit into
zai-org:mainfrom
pavel-osetrov:feat/twelvedata
Open

pavel-osetrov wants to merge 1 commit into
zai-org:mainfrom
pavel-osetrov:feat/twelvedata

Conversation

@pavel-osetrov

Copy link
Copy Markdown

Plugin type (required) / 插件类型(必填)

  • UI Plugin / 是 UI 插件 — provides MCP Apps interactive pages / 提供 MCP Apps 交互页面
  • Standard plugin / 普通插件(非 UI) — does not provide MCP Apps interactive pages / 不提供 MCP Apps 交互页面
  • Not applicable / 不适用 — repository-only changes; no plugin content changed / 仅仓库级改动,不涉及插件内容

Affected plugin name(s) / 涉及的插件名称:twelvedata

What / 改动内容

Adds twelvedata, a community plugin from Twelve Data that connects ZCode to the official Twelve Data MCP server at https://mcp.twelvedata.com/mcp.

User problem. Agents in ZCode often need market data: symbols, quotes, price history, technical indicators, fundamentals. Without the plugin, users add the remote server by hand. With it, they install from the marketplace and sign in.

What's in the plugin. One remote HTTP MCP server declared in .mcp.json. There are no commands, hooks, skills, agents, local processes or UI pages. The server exposes tools for symbol search, quotes and time series, technical indicators, fundamentals, ETF and mutual fund data, and reference data. It covers stocks, ETFs, mutual funds, indices, forex and crypto.

Auth. Standard MCP OAuth. The server has no API key, headers or userConfig. The user clicks Open authorization in Settings → MCP Servers and signs in with a Twelve Data account. ZCode registers its own client through dynamic client registration and receives the code on a loopback address.

Dependencies and permissions.

  • Network: HTTPS to mcp.twelvedata.com only.
  • Account: requires a Twelve Data account. A free plan is available.
  • Data and limits: tool calls count toward the user's Twelve Data plan and follow its coverage and rate limits.
  • Local side effects: none. The plugin writes no files and runs no local code.

Testing. Tested in ZCode on macOS on 2026-11-03, with the model GLM-5.3-Flash and no Coding Plan:

  1. Added this exact plugin directory as a local marketplace (Add plugin marketplace → Choose directory) and installed it from Personal.
  2. The server appeared under the Twelve Data section with Open authorization. After sign-in it showed "This plugin MCP server is connected and available".
  3. The prompt "Use Twelve Data to get the latest quote for AAPL, including price and volume." called mcp__plugin_twelvedata_twelvedata__get_quote and returned correct data.
  4. Before packaging, the same server was also tested as a manually added MCP server. search_symbol, get_quote, get_time_series and get_technical_indicator all worked, and the session survived an app restart without a new sign-in.
24-zcode-plugin-installed-personal 25-zcode-plugin-open-authorization 26-zcode-plugin-consent-dcr 27-zcode-plugin-connected 28-zcode-plugin-quote

Version. New plugin, 0.1.0 in both plugin.json and marketplace.json.

Icon and provenance. assets/twelvedata/icon.png is the official Twelve Data icon, https://twelvedata.com/build/favicons/favicon-512.png (512×512 PNG), unmodified. It is recorded in assets/icon-sources.json with its sha256. The marketplace entry points to the CDN path the publish pipeline uses. There is no third-party code. Data is provided under the Twelve Data terms: https://twelvedata.com/terms.

Self-check / 自查清单

  • Plugin name is unique kebab-case; new external plugin directory is external_plugins/<name>/; existing fixes retain ownership / 插件名唯一且 kebab-case,外部新增插件位于 external_plugins/<name>/,已有插件修复保留原归属
  • Usage category is set independently of publisher ownership / 用途分类 category 已填写,与维护归属分开
  • Plugin type and affected names are declared above / 已在上方声明插件类型与涉及的插件名称
  • version bumped in BOTH plugin.json and marketplace.json (artifacts are immutable) / plugin.json 与 marketplace.json 两处版本号已同步升级(制品不可变)
  • README.md (EN) and README_CN.md (中文) both updated and equivalent / 中英文 README 均已更新且语义一致
  • description_i18n has both en and zh-CN / description_i18n 包含 en 与 zh-CN
  • No secrets, machine-specific paths, or private dependencies / 不含密钥、机器专属路径或私有依赖
  • Model/API/network dependencies documented / 模型、API、网络依赖已写明
  • python3 scripts/validate.py and python3 scripts/build_dist.py pass locally / 本地校验与构建均通过
    validate.py passes (53 plugins) and tests/test_icon_assets.py passes. A full local build_dist.py run stops on unrelated UI plugins that need Node 24 and a Rust toolchain (photocraft: "rustup is required"). This plugin has no ui-plugins/ source and no local MCP paths, so its packaging takes the plain directory path.

@panda920

panda920 commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants